QuickTime 3 Reference

Previous | Chapter Top | Chapter Contents | Next

Controlling Sequence Grabber Components

SGGrabPict

QuickTime 1.6.1 added a new flag to the grabPictCurrentImage parameter to the SGGrabPict function.

enum {
    grabPictCurrentImage            = 4
};

Constant descriptions

grabPictCurrentImage
Set this flag to 1 to provide the fastest possible image capture. Although this flag may fail under certain circumstances, this failure is recoverable; it just will not return a picture. You can then call SGGrabPict again without the flag set. This routine does not pause the current preview or grab the next frame. It just causes the currently displayed image to be captured. It's a good idea to call SGPause before calling SGGrabPict with this flag.

SGGetMode

Returns the mode for a sequence grabber component.

pascal ComponentResult SGGetMode (
                     SeqGrabComponent s,
                     Boolean *previewMode,
                     Boolean *recordMode);
s
Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.
previewMode
Contains a pointer to a Boolean. The sequence grabber component sets this field to true if the component is in preview mode.
recordMode
Contains a pointer to a Boolean. The sequence grabber component sets this field to true if the component is in record mode.

DISCUSSION

The SGGetMode function provides a convenient mechanism for determining whether a sequence grabber component is in preview mode or record mode.

RESULT CODES

To be provided


© 1997 Apple Computer, Inc.

Previous | Chapter Top | Chapter Contents | Next